home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / util / boot / VXLShell_13.lha / VXLShell / VXLShell13.doc < prev    next >
Encoding:
Text File  |  1995-04-04  |  8.1 KB  |  176 lines
  1. *************************************************************************
  2. *                                                                       *
  3. *           VXLShell v1.3 (20-Jun-1994) by Per-Olof Yliniemi            *
  4. *                                                                       *
  5. *               Copyright © 1993 - All Rights Reserved                  *
  6. *                                                                       *
  7. *************************************************************************
  8. *                                                                       *
  9. * DISCLAIMER: No responsibility can be taken on the part of the  author *
  10. *   for any  consequences  that may  occur  as a result  of using  this *
  11. *   program.  Every part of the  program has been  thoroughly tested to *
  12. *   to its specified limits and any  known specific  limitations of the *
  13. *   the program are stated within this documentation.                   *
  14. *                                                                       *
  15. *************************************************************************
  16. *                                                                       *
  17. * COPYRIGHT: This program is  DISKWARE.  If you use it,  send me one or *
  18. *   more  disk(s)  with freely  distributable  programs (PD, Shareware, *
  19. *   Freeware, ???ware).  The program may be  freely distributed as long *
  20. *   as all files are distributed and unmodified.                        *
  21. *                                                                       *
  22. *   The  program  may  not be  sold for any profit  (a nominal  fee for *
  23. *   copying is accepted).                                               *
  24. *                                                                       *
  25. *   This program may not be used as a  part of any  commercial packages *
  26. *   without my permission.  The source code for this program may not be *
  27. *   reproduced by disassembling or reversing the development process in *
  28. *   any way.                                                            *
  29. *                                                                       *
  30. *************************************************************************
  31.  
  32.      About this program:
  33.     ---------------------
  34. This program is for you out there who have  a  Microbotics  VXL-30  turbo
  35. board attached to your computer.
  36.  
  37. This program is only a graphical interface for  the  SetVXL  program.  It
  38. uses  the SetVXL software that came along with the accelerator board, but
  39. can be used for Cache/Burst control for 68030 without it.
  40.  
  41.      Installation:
  42.     ---------------
  43. This package should contain the following files:
  44.  
  45.      VXLShell11              The old version of the executable (4864 bytes)
  46.      VXLShell13              The new executable (3084 bytes)
  47.      VXLShell13.info         The icon for the executable
  48.      VXLShell13.doc          This documentation (8276 bytes)
  49.      VXLShell13.doc.info     The icon for the doc file
  50.  
  51. Copy  the  SetVXL  command to C: and this program and its icon to another
  52. drawer. If you are installing the old version (1.1) of this  program,  do
  53. a copy of the VXLShell13.info file and name it VXLShell11.info.
  54.  
  55. The program can be executed from CLI or Workbench and opens a window with
  56. some gadgets.
  57.  
  58.       Gadgets:
  59.      ----------
  60.  
  61. The  right  side  of  the  window  contains  a  group of four gadgets for
  62. Cache/Burst control and do not require the SetVXL software. The left side
  63. of the window also contains a group of  four  gadgets,  to  select  which
  64. arguments  to  send  to  SetVXL.  The bottom of the window contains three
  65. gadgets. The one in the middle is used by SetVXL.
  66.  
  67.             Memory Control                  Cache & Burst Control
  68.    |-------------| |-------------|     |-------------| |-------------|
  69.    | @ | MapHigh | |   FastROM   |     |    ICache   | |    IBurst   |
  70.    |-------------| |-------------|     |-------------| |-------------|
  71.  
  72.    |-------------| |-------------|     |-------------| |-------------|
  73.    | @ |  MBROM  | |   AddMem    |     |    DCache   | |    DBurst   |
  74.    |-------------| |-------------|     |-------------| |-------------|
  75.                                 Processor
  76.    |-------------|           |-------------|           |-------------|
  77.    |     USE     |           | @ | 68030   |           |     QUIT    |
  78.    |-------------|           |-------------|           |-------------|
  79.  
  80. Due to a little bug in intuition the cycle gadgets have  a  little  weird
  81. behaviour.  When pressed, the window contents disappears a short time and
  82. is then redrawn to update the  gadget  imagery  (I'm  using  one  of  the
  83. methods described in the RKM:Libraries manual).
  84.  
  85. The  RefreshGList  routine  didn't  work correct with my gadgets for this
  86. program (borders...). This  could  have  been  solved  by  replacing  all
  87. gadgets  with  images, but I did the opposite when this program went from
  88. v1.1 to v1.2 (larger gadgets). For those of you who don't like  this  way
  89. of  updating  the gadget images, use the old version of this program that
  90. is included with this version.
  91.  
  92.  Memory Control (explained from top left to bottom right):
  93. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  94. MapHigh / MapLow cycle gadget:
  95.    For the MapHigh / MapLow arguments  to  SetVXL.  This  gadget  selects
  96.    which  address  the RAM-32 memory should be placed at when it is added
  97.    to the system. Defaults to MapHigh when the program is started.
  98.  
  99. FastROM gadget:
  100.    For the FastROM option in the SetVXL program. Copies the active ROM to
  101.    512k of the 32-bit RAM attached to the VXL-30 board.  Default  =  OFF.
  102.    SetVXL equivalent: FastROM / NoFastROM.
  103.  
  104. MBROM / VXLROM cycle gadget:
  105.    Selects  which  ROM  chip  that should be used. The RAM-32 board has a
  106.    socket for a ROM-chip. This gadget selects if the computer should  use
  107.    the  ROM  in  the  socket  on  the  RAM-32  board  or  the  ROM on the
  108.    motherboard. Defaults to MBROM when the program is started.
  109.  
  110. AddMem gadget:
  111.    This gadget tells SetVXL to add the memory on the RAM-32 board to  the
  112.    system.  The address is selected with the MapHigh/MapLow cycle gadget.
  113.    SetVXL equivalent: AddMem. Default = OFF.
  114.  
  115.  
  116.  Cache & Burst Control (explained from top left to bottom right):
  117. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  118. All these gadgets are only available when the  Processor gadget is set to
  119. 68030. The default values for these gadgets are the current state.
  120.  
  121. ICache:
  122.    Controls the instruction cache of the processor.
  123.    SetVXL equivalent: InstCache/NoInstCache.
  124.  
  125. IBurst:
  126.    Controls the memory instruction burst mode.
  127.    SetVXL equivalent: InstBurst/NoInstBurst.
  128.  
  129. DCache:
  130.    Controls the data cache of the processor.
  131.    SetVXL equivalent: DataCache/NoDataCache.
  132.  
  133. DBurst:
  134.    Controls the memory data burst mode.
  135.    SetVXL equivalent: DataBurst/NoDataBurst.
  136.  
  137.  
  138.  The bottom row of gadgets (explained from left to right):
  139. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  140. USE:
  141.    Uses the settings selected with the gadgets. Does  the  reboot  within
  142.    5 seconds (as with SetVXL) if necessary.
  143.  
  144. 68030/68000:
  145.    Selects  which  processor to use. Defaults to the processor that is in
  146.    use. SetVXL equivalent: 68030 / 68000.
  147.  
  148. QUIT:
  149.    Ignores all changes and exits the program immediatly.
  150.  
  151. ---------------------------------------------------------------------------
  152.  
  153.  All kinds of freely distributable programs (new software...) are accepted
  154.  as a contribution for this program. If you are a programmer, send me some
  155.  of your own code.
  156.  
  157.  Contributions for this program and bug reports should be sent to:
  158.  
  159.  
  160.                       Per-Olof Yliniemi
  161.                       Muoniovaara
  162.                       S-980 64 Muodoslompolo
  163.                       SWEDEN
  164.  
  165. Note 1:
  166.  If you want to have the source code for this program, and  maybe  use  it
  167.  in  your  own programs, send me some equivalent assembly language program
  168.  that YOU have written (about 1000 lines of source, 3k exe).
  169.  
  170. Note 2:
  171.  Everything that appears to be a bug in this program that occurs AFTER the
  172.  USE gadget has been pressed is a bug in the SetVXL software. I know  that
  173.  there is some, but I don't remember 'em right now...
  174.  
  175. ---------------------------------------------------------------------------
  176.